home *** CD-ROM | disk | FTP | other *** search
/ CU Amiga Super CD-ROM 18 / CU Amiga Magazine's Super CD-ROM 18 (1997)(EMAP Images)(GB)[!][issue 1998-01].iso / CUCD / Online / hsc / docs-source / install.hsc < prev    next >
Encoding:
Text File  |  1997-11-02  |  3.9 KB  |  123 lines
  1. <WEBPAGE chapter="hsc - " title="Installation"
  2.          PREV="distrib.html"
  3.          NEXT="options.html">
  4.  
  5. This chapter will explain where all the files coming with the
  6. archive should end up. <*; it least for AmigaOS. For other systems,
  7. refer to <ln-existing-ports>.*>
  8.  
  9. <H2>AmigaOS</H2>
  10.  
  11. Because there is not much to do, there is no installer script. You
  12. will have to perform some simple steps the first time you install
  13. <hsc>. If the descriptions below are not sufficient for you to figure
  14. out what to do, you don not want to use this tool anyway.
  15.  
  16. <H3>Simple Installation</H3>
  17.  
  18. <P>It's recommended to leave the whole <hsc> directory in one piece.
  19. Therefor extract the archive somewhere to your hard disk,
  20. for example to <FILE>work:hsc</FILE>.</P>
  21.  
  22. You now have to add this directory to your workbench search path.
  23. This can be performed adding a line like the one you can find
  24. below to your <FILE>user-startup</FILE>
  25.  
  26. <PRE>Path work:hsc ADD</PRE>
  27.  
  28. After rebooting, you can open a CLI and type in <qq><KBD>hsc
  29. help</KBD></qq>, and <hsc> should come up with a short information
  30. message.
  31.  
  32. <H3>Minimum Installation</H3>
  33.  
  34. <P>For a minimum installation, only <FILE>hsc</FILE> and <FILE>hsc.prefs</FILE>
  35. are required. If you want to utilize the project management capabilities of 
  36. <hsc>, also <hscdepp> and <hscpitt> are required.</P>
  37.  
  38. <P>Copy the binaries to somewhere in your workbench search path (for 
  39. exmple, to <FILE>c:</FILE>) and <hsc.prefs> anywhere else and set
  40. <env_hscpath> according to this.</P>
  41.  
  42. <H3>Making It Resident</H3>
  43.  
  44. <P>All binaries should already have the the pure bit set. If not, you
  45. can do this by entering</P>
  46.  
  47. <PRE>
  48. protect hsc/hsc add p
  49. protect hsc/hscdepp add p
  50. protect hsc/hscpitt add p
  51. </PRE>
  52.  
  53. <P>in CLI.</P>
  54.  
  55. <P>To make the binaries resident on every startup, add the lines</P>
  56.  
  57. <PRE>
  58. resident hsc
  59. resident hscdepp
  60. resident hscpitt
  61. </PRE>
  62.  
  63. <P>to the <FILE>user-startup</FILE>.</P>
  64.  
  65. <P><STRONG>Important:</STRONG> For resident programs,
  66. <CODE>PROGDIR:</CODE> is not defined. You will have to take care that
  67. <hsc> is able to find <hsc.prefs> before it tries to scan
  68. <CODE>PROGDIR:</CODE> for it. This can be done by by setting the
  69. environment variable <env_hscpath> or by placing <hsc.prefs> in the
  70. current directory for every project. Otherwise you will notice an
  71. annoying requester, which will ask you to <QQ>insert volume
  72. PROGDIR: into any drive</qq>.</P>
  73.  
  74. <H2>RiscOS</H2>
  75.  
  76. For the RiscOS distribution, you can find a file called
  77. <FILE>ReadMe</FILE> in the directory <FILE>riscos</FILE> explaining
  78. these details.
  79.  
  80. <H2><NextStep>, AmigaOS/ixemul, BeOS, Unixoid Systems</H2>
  81.  
  82. <P>Maybe you will have to compile the sources yourself. Refer to
  83. the chapter about the <A HREF=":source.html">Source Code</A> for
  84. details.</P>
  85.  
  86. <P>For installation, the first few lines of this <makefile> are
  87. interesting for you. They define two symbols you might want to change.
  88. <CODE>INSTALL</CODE> specifies the <exec>install</exec> program to be
  89. used. Normally the default should be fine.</P>
  90.  
  91. <P>An exception of this is when you want to compile for <A
  92. HREF=":ports.html#amixemul">AmigaOS/ixemul</A>. In
  93. this case you maybe want to set <CODE>INSTALL=/bin/install</CODE> or
  94. otherwise <FILE>sys:c/install</FILE> will be used, which does a
  95. completely different job - it makes a disk bootable.</P>
  96.  
  97. <P>The default for <CODE>INSTDIR</CODE> will attempt to to copy the
  98. binaries to <FILE>/usr/bin/</FILE> and some other data to
  99. <FILE>/usr/lib/</FILE>. This will only work if you have write access
  100. to these directories.</P>
  101.  
  102. If you are normal luser, you can modify this symbol to for instance
  103.  
  104. <PRE>INSTDIR = $(HOME)/</PRE>
  105.  
  106. Make sure that you also have created <FILE>$HOME/bin/</FILE> and
  107. <FILE>$HOME/lib/</FILE> before starting the installation process. Or
  108. maybe you prefer
  109.  
  110. <PRE>
  111. INSTDIR = /usr/local
  112. </PRE>
  113.  
  114. because of philosophical reasons I never really understood. In any
  115. case, a
  116.  
  117. <PRE>make install</PRE>
  118.  
  119. should copy all files to the desired locations.
  120.  
  121.  
  122. </WEBPAGE>
  123.